使用主题 (Theme)

Kanzi 将主题 (Theme) 用作 ID 来选择与主题 (Theme) 相关的资源。如果您未定义主题 (Theme) 的资源，Kanzi 会使用该主题组 (Theme Group) 中的该资源 ID 的默认值。

完成教程，了解如何为您的Kanzi 应用程序制定主题。请参阅教程：为应用程序制定主题。

创建主题 (Theme)

Kanzi 将主题 (Theme) 用作 ID 来选择与主题 (Theme) 相关的资源。如果您未定义主题 (Theme) 的资源，Kanzi 会使用该主题组 (Theme Group) 中的该资源 ID 的默认值。

要创建主题 (Theme)：

在素材库 (Library) > 主题 (Theme) 中双击要添加主题 (Theme) 的主题组 (Theme Group)。
Kanzi Studio 在主题编辑器 (Theme Editor) 中打开主题组 (Theme Group)。
在主题编辑器 (Theme Editor) 中点击创建主题 (Create Theme)，输入主题 (Theme) 的名称，并点击确定 (OK)。

重命名主题 (Theme)

要更改现有主题 (Theme) 的名称：

在素材库 (Library) > 主题 (Theme) 中双击含有要重命名的主题 (Theme) 的主题组 (Theme Group)。
在主题编辑器 (Theme Editor) 中右键点击要重命名的主题 (Theme) 头文件并选择重命名 (Rename)。
为主题 (Theme) 输入新名称并点击确定 (OK)。

设置应用程序主题 (Theme)

您可以通过这些方式设置应用程序主题 (Theme)：

要设置当用户启动应用程序时应用程序使用的或要在 Kanzi Studio 预览 (Preview) 中查看的主题 (Theme)：
- 在素材库 (Library) > 主题 (Theme) 选择包括要使用的主题 (Theme) 的主题组 (Theme Group)，并将选定主题 (Selected Theme) 设置为想要使用的主题 (Theme)。
- 在字典 (Dictionaries) 窗口中点击地区和主题 (Locales and Themes)，并为您工程中的每个主题组 (Theme Group) 选择要使用的主题 (Theme)。
要使用触发器设置主题 (Theme)，向要用于设置应用程序主题的节点添加任何触发器，在激活主题 (Activate Theme) 动作中设置要使用的主题 (Theme)，并点击保存 (Save)。

手动向主题组 (Theme Group) 添加资源

向主题组 (Theme Group) 添加资源最快速的方式是在工程 (Project) 中使用添加资源至主题组 (Add Resources to a Theme Group) 命令。请参阅将工程中使用的资源添加到主题组 (Theme Group)。

要手动向主题组 (Theme Group) 添加资源：

在素材库 (Library) > 主题 (Theme) 中双击含有要手动添加资源的主题 (Theme) 的主题组 (Theme Group)。
Kanzi Studio 在主题编辑器 (Theme Editor) 中打开主题组 (Theme Group)。
在主题编辑器 (Theme Editor)中点击+ 添加资源 (+ Add Resource) 并选择：
- 创建 (Create) 并选择要创建的资源的类型。
- 添加现有 (Add Existing) 并选择工程中已有的资源。
为用于该资源的资源 ID 输入名称，并点击确定 (OK)。
在每个主题 (Theme) 栏的主题编辑器 (Theme Editor) 中，为您创建的资源 ID 设置要使用的资源。
在工程 (Project) 中选择要使用您创建的资源 ID 的节点，在属性 (Properties) 中将指向资源的属性设置为 < Resource ID >，并输入在主题编辑器 (Theme Editor) 中创建的资源 ID。

从主题组 (Theme Group) 删除资源 ID

要从主题组 (Theme Group) 删除资源 ID：

要删除该工程中未使用资源 ID，点击清理 (Clean)，选择要删除的资源 ID 并点击确定 (OK)。
要删除资源 ID，右键点击资源 ID 并选择删除资源 ID (Delete Resource ID)。
要删除多个资源 ID，按 Ctrl 或 Shift 键并选择要删除的资源 ID，并按 Delete 键。

本地化主题 (Theme)

Kanzi 可以让您将主题应用程序本地化。

要本地化主题：

对于每个您要将其内容本地化的主题，从包含要本地化的文本节点的内容创建预设件。请参阅创建和使用预设件。
本地化文本资源：
1. 在预设件 (Prefabs) 中选择您在上一步中创建的预设件并将其资源添加到本地化表。请参阅添加资源至本地化表。
2. 在素材库 (Library) > 本地化 (Localization) 中双击上一步中创建的本地化表，使其在本地化编辑器 (Localization Editor) 中打开，然后添加要将其主题本地化的地区，并本地化文本资源。请参阅本地化文本资源。
  要添加地区，点击+ 创建地区 (+ Create Locale)，输入地区名称，然后点击确定 (OK)。
使用预设件视图 (Prefab View) 节点显示已本地化的内容：
1. 在要显示您已本地化的内容的节点下的预设件 (Prefabs) 中，创建一个预设件视图 (Prefab View) 节点并在属性 (Properties) 中添加和设置预设件模板 (Prefab Template) 属性为您在第 1 步中创建的预设件之一。
  您必须使用预设件视图 (Prefab View) 节点，以便动态更改预设件视图 (Prefab View) 实例化的预设件。请参阅预设件占位符 (Prefab Placeholder) 和预设件视图 (Prefab View) 节点。
2. 在预设件 (Prefabs) 中右键点击在上一步中创建的预设件视图 (Prefab View) 节点并选择添加资源至主题组 (Add Resources to a Theme Group)。
3. 在添加资源至主题组 (Add Resources to a Theme Group) 窗口中：
  - 将主题组 (Theme Group) 设为要添加资源的主题组。
    主题组包含有关哪个主题使用哪些资源的信息。
  - 将资源 ID (Resource ID) 重命名为在工程上下文中有意义的内容。
  点击添加 (Add)。
  Kanzi Studio 向主题组添加指向值 (Value) 列中所示预设件的资源 ID。在您将资源从中添加到主题组 (Theme Group) 的预设件视图 (Prefab View)节点中，Kanzi Studio 会将预设件模板 (Prefab Template) 属性的值设置为资源 ID。
4. （可选）在预设件 (Prefabs) 中将第一步中创建的预设件视图 (Prefab View) 节点复制到要显示相同内容的位置。
5. 在素材库 (Library) > 主题 (Theme) 中双击添加了资源的主题组，然后在主题编辑器 (Theme Editor) 中为第 3 步中创建的资源 ID 选择每个主题的正确预设件。
要在字典 (Dictionaries) 窗口中查看工程中的本地化表和主题组资源字典，点击地区和主题 (Locales and Themes)，然后选择不同的地区和主题以查看预览 (Preview) 中的本地化主题。

在多个 Kanzi Studio工程组合到 Kanzi应用程序中使用主题

要在组合多个Kanzi Studio 工程到Kanzi 应用程序时使用工程，您必须通过以下方式之一制作应用程序的主工程屏幕 (Screen) 节点可访问的主题组。

在应用程序的主工程中定义主题组。
将引用工程的主题组合并到包含屏幕 (Screen) 节点的主工程。然后，您可以使用资源 ID 访问引用工程的主题组中的资源。请参阅合并工程。
联系 Rightware 支持团队，请求获取 Kanzi Engine 插件，它能让您在多个 Kanzi Studio 工程和 kzb 文件上使用主题。请参阅提交支持请求。